home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / complib / fft3dui.z / fft3dui
Text File  |  1998-10-30  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. ssssccccfffffffftttt3333dddduuuuiiii,,,,ddddzzzzfffffffftttt3333dddduuuuiiii((((3333FFFF))))                                ssssccccfffffffftttt3333dddduuuuiiii,,,,ddddzzzzfffffffftttt3333dddduuuuiiii((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssssccccfffffffftttt3333dddduuuuiiii,,,, ddddzzzzfffffffftttt3333dddduuuuiiii ---- initialize the coefficient array for real-to-
  10.      complex 3D FFT modules.
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSYYYYSSSS
  13.      _F_O_R_T_R_A_N _S_P_E_C_I_F_I_C_A_T_I_O_N
  14.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee SSSSCCCCFFFFFFFFTTTT3333DDDDUUUUIIII(((( nnnn1111,,,, nnnn2222,,,, nnnn3333,,,, ccccooooeeeeffffffff ))))
  15.      iiiinnnntttteeeeggggeeeerrrr                  nnnn1111,,,, nnnn2222,,,, nnnn3333
  16.      rrrreeeeaaaallll           ccccooooeeeeffffffff((((((((nnnn1111++++11115555)))) ++++ 2222****((((nnnn2222++++11115555)))) ++++ 2222****((((nnnn3333++++11115555))))))))
  17.  
  18.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee DDDDZZZZFFFFFFFFTTTT3333DDDDUUUUIIII(((( nnnn1111,,,, nnnn2222,,,, nnnn3333,,,, ccccooooeeeeffffffff ))))
  19.      iiiinnnntttteeeeggggeeeerrrr                  nnnn1111,,,, nnnn2222,,,, nnnn3333
  20.      rrrreeeeaaaallll****8888              ccccooooeeeeffffffff((((((((nnnn1111++++11115555)))) ++++ 2222****((((nnnn2222++++11115555)))) ++++ 2222****((((nnnn3333++++11115555))))))))
  21.  
  22.      _C _S_P_E_C_I_F_I_C_A_T_I_O_N
  23.      ####iiiinnnncccclllluuuuddddeeee <<<<fffffffftttt....hhhh>>>>
  24.      ffffllllooooaaaatttt ****ssssccccfffffffftttt3333dddduuuuiiii(((( iiiinnnntttt nnnn1111,,,, iiiinnnntttt nnnn2222,,,, nnnn3333,,,, ffffllllooooaaaatttt ****ccccooooeeeeffffffff))));;;;
  25.  
  26.      ddddoooouuuubbbblllleeee ****ddddzzzzfffffffftttt3333dddduuuuiiii(((( iiiinnnntttt nnnn1111,,,, iiiinnnntttt nnnn2222,,,, nnnn3333,,,, ddddoooouuuubbbblllleeee ****ccccooooeeeeffffffff))));;;;
  27.  
  28.  
  29. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  30.      Initialize, the coefficient array which is used in the 3D FFT modules.
  31.      This array contains the different twiddle factors and the factorization
  32.      of N1, N2 and N3 into prime numbers.
  33.      As the FFT modules scfft3d or dzfft3d only read the _c_o_e_f_f array, it may
  34.      be reused as many times as necessary once it has been initialized.
  35.  
  36.      In C, if _p_t_r is NULL, _s_c_f_f_t_3_d_u_i or _d_z_f_f_t_3_d_u_i returns a pointer to an
  37.      allocated buffer.
  38.  
  39.      SCFFT3DUI should be used to initialize the coefficient array before any
  40.      call to SCFFT3DU
  41.      DZFFT3DUI should be used to initialize the coefficient array before any
  42.      call to DZFFT3DU
  43.  
  44. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  45.      NNNN1111 ---- Integer. Specifies the size of the first dimension of the 3D
  46.      sequence to be transformed.  Unchanged on exit.
  47.  
  48.      NNNN2222 ---- Integer. Specifies the size of the second dimension of the 3D
  49.      sequence to be transformed.  Unchanged on exit.
  50.  
  51.      NNNN3333 ---- Integer. Specifies the size of the third dimension of the 3D
  52.      sequence to be transformed.  Unchanged on exit.
  53.  
  54.      CCCCOOOOEEEEFFFFFFFF ---- Array (C or Fortran) or NULL pointer(C).
  55.  
  56. EEEExxxxaaaammmmpppplllleeee ooooffff CCCCaaaalllllllliiiinnnngggg SSSSeeeeqqqquuuueeeennnncccceeee
  57.      Initializing a coefficient array for real-to-complex FFTs of size 200 x
  58.      300 x 125.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssccccfffffffftttt3333dddduuuuiiii,,,,ddddzzzzfffffffftttt3333dddduuuuiiii((((3333FFFF))))                                ssssccccfffffffftttt3333dddduuuuiiii,,,,ddddzzzzfffffffftttt3333dddduuuuiiii((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      _F_o_r_t_r_a_n :
  75.           real coeff((200+15)+2*(300+15)+2*(125+15))
  76.           call scfft3dui( 200, 300, 125, coeff)
  77.  
  78.      _C :
  79.           #include <fft.h>
  80.           float *coeff;
  81.           coeff = scfft3dui( 200, 300, 125, NULL);
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.           fft, scfft3du, dzfft3du
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.